home *** CD-ROM | disk | FTP | other *** search
/ PC Media 2 / PC MEDIA CD02.iso / share / udos / isthere / isthere.doc < prev    next >
Encoding:
Text File  |  1992-05-02  |  1.7 KB  |  51 lines
  1. ISTHERE
  2.  
  3. Bob Flanders and Michael Holmes                   May 2, 1992
  4. Current version: 1.00 - May 2, 1992
  5.  
  6. Purpose:     A short C program to test if enough spaced is available on the
  7.          requested drive.
  8.  
  9. Format:      ISTHERE n [d:]
  10.  
  11.          n    is a number in the format n, nK or nM
  12.         n is an exact value (example: 50000)
  13.         nK is a value where n is multiplied by 1K (example: 24k)
  14.         nM is a value where n is multiplied by 1 meg (example: 1M)
  15.  
  16.          d: is an optional drive letter followed by a colon.
  17.  
  18. Remarks:     ISTHERE allows you to check if enough space exists on the
  19.          specified drive. If you do not specify a drive, the current
  20.          drive is checked.
  21.  
  22.          You may replace the "n" on the command line with a value in
  23.          one of three formats: an exact value, a value in K bytes or
  24.          value in MegaBytes.  For example, if you want to check that
  25.          there are at least 50,000 bytes available on the current drive,
  26.          you would issue the command:
  27.  
  28.         ISTHERE 50000
  29.  
  30.          If you wanted to check for 500K being available on drive E:,
  31.          you would issue the command:
  32.  
  33.         ISTHERE 500K E:
  34.  
  35.          ISTHERE returns both a message and a DOS errorlevel. The
  36.          message describes any error that occurred or the results of
  37.          the test.    The errorlevel will be one of three values:
  38.  
  39.         0: The space is available
  40.         1: The space is not available
  41.         2: An error occurred - command line syntax, bad drive or
  42.             drive not ready.
  43.  
  44.          ISTHERE will not hang for an I/O error.  If you have such an
  45.          error, it will return errorlevel 2 and an error message.
  46.  
  47.          The batch file SPACE.BAT gives an example of using ISTHERE
  48.          withing a batch program.
  49.  
  50. -- Bob Flanders 72451,2611.
  51.